home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / rtmon-dump.z / rtmon-dump
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. RRRRTTTTMMMMOOOONNNN----DDDDUUUUMMMMPPPP((((1111))))                                                    RRRRTTTTMMMMOOOONNNN----DDDDUUUUMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rtmon-dump - dump the contents of events collect from rtmond
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rrrrttttmmmmoooonnnn----dddduuuummmmpppp [ _o_p_t_i_o_n_s ] [ file ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      rrrrttttmmmmoooonnnn----dddduuuummmmpppp prints binary event data collected from an rrrrttttmmmmoooonnnndddd(1) server
  16.      process using rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt(1) or ppppaaaaddddcccc(1).  Data can be read from a file
  17.      or from the standard input.  By default, rrrrttttmmmmoooonnnn----dddduuuummmmpppp displays all
  18.      interesting events found in a file using the same format as ppppaaaarrrr(1).
  19.      Various options are provided for filtering which events are printed and
  20.      how they are displayed.
  21.  
  22. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.      ----dddd _u_s_e_c_s
  24.           Use _u_s_e_c_s for the threshold for displaying system calls as begin and
  25.           end entries.  By default, rrrrttttmmmmoooonnnn----dddduuuummmmpppp will display system call events
  26.           as single line if there are no events to display between the start
  27.           and finish of the system call and if the duration of the system is
  28.           less than a nominal threshold (default 2 milliseconds).  If a system
  29.           call takes longer than this threshold than it is displayed as
  30.           separate begin and end events so that it is easy to pick out long-
  31.           running calls.
  32.  
  33.      ----ffff   Follow the growth of event data collected in a file.  If a file is
  34.           specified on the command line and the ----ffff option is specified, then
  35.           rrrrttttmmmmoooonnnn----dddduuuummmmpppp will dump the contents of the file and then periodically
  36.           monitor it for new data.  In this situation rrrrttttmmmmoooonnnn----dddduuuummmmpppp will never
  37.           exit voluntarily; it must be terminated with an interrupt signal
  38.           (e.g. from a keyboard interrupt).
  39.  
  40.      ----iiii   Display ``internal'' event as well as normal events.  This option
  41.           causes the display of certain events that are normally used only in
  42.           decoding other events:  CPU configuration, task names, process
  43.           execs, etc.
  44.  
  45.      ----mmmm _e_v_e_n_t-_m_a_s_k
  46.           Display only events specified by _e_v_e_n_t-_m_a_s_k.  An _e_v_e_n_t _m_a_s_k
  47.           specifies a set of events; it is a set of _e_v_e_n_t _c_l_a_s_s_e_s with each
  48.           class specified symbolically as one of the following:
  49.  
  50.           NNNNaaaammmmeeee        DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  51.           all         All events (default)
  52.           alloc       Memory allocation
  53.           disk        Disk i/o work
  54.           intr        Hardware interrupts
  55.           io          I/O-related events (disk+intr)
  56.           netflow     Network I/O flow
  57.           netsched    Network I/O scheduling
  58.           network     Network-related events (netflow+netsched)
  59.           none        No events
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRTTTTMMMMOOOONNNN----DDDDUUUUMMMMPPPP((((1111))))                                                    RRRRTTTTMMMMOOOONNNN----DDDDUUUUMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74.           profile     Kernel profiling
  75.           scheduler   Process and thread scheduler
  76.           signal      Signal delivery and reception
  77.           syscall     System calls and their arguments
  78.           task        Process and thread scheduling
  79.           vm          Virtual memory operation
  80.  
  81.           Event class names are case insensitive; i.e. ``SIGNAL'' is
  82.           interpreted the same as ``signal''.  Multiple event classes may be
  83.           included by using a ``+'', ``|'', or ``,'' symbol to separate the
  84.           names.  Event classes may be excluded by using a ``-'' to separate
  85.           the name.  For example, ``network+io-disk'' indicates all network
  86.           and i/o events should be included except for disk-related events.
  87.           In addition to the above names, a number may be used to specify a
  88.           value, where the various events are selected by bits in the value,
  89.           as defined in ``<sys/rtmon.h>''.
  90.  
  91.      ----OOOO   Print unrecognized event data in octal instead of decimal.
  92.  
  93.      ----xxxx   Print unrecognized event data in hexadecimal instead of decimal.
  94.  
  95.      ----pppp _c_p_u-_l_i_s_t
  96.           Display only events from certain CPUs.  CPUs are specified as a
  97.           comma-separated list of CPU numbers or range of CPU numbers.  CPUs
  98.           are numbered starting at zero.  For example, ----pppp _1,_4-_7,_1_1 means
  99.           processors 1, 4, 5, 6, 7, and 11.  An open-ended range is
  100.           interpreted as all CPUs to the maximum CPU number; e.g.  _2- on an
  101.           8-processor system is the same as _2-_7.  The CPU list must be one
  102.           string with no white space.  By default, rrrrttttmmmmoooonnnn----dddduuuummmmpppp displays events
  103.           from all CPUs.
  104.  
  105.      ----rrrr   Display event decoding; display all events as raw data.
  106.  
  107.      ----uuuu   Display event times as milliseconds with a microsecond fraction and
  108.           show the number of microseconds between displayed events.
  109.  
  110.      ----vvvv   Enable verbose output.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      ppppaaaaddddcccc(1), ppppaaaarrrr(1), rrrrttttmmmmoooonnnndddd(1), rrrrttttmmmmoooonnnn____lllloooogggg____uuuusssseeeerrrr____ttttssssttttaaaammmmpppp(3)
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.